home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Applications 1998 June / SGI IRIX 6.5 Applications 1998 June.iso / dist / dynaweb.idb / usr / relnotes / dynaweb / ch2.z / ch2
Text File  |  1998-05-04  |  10KB  |  263 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists supplemental information to the _I_R_I_S
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The information listed here is
  12.        product- and release-specific; use it with the Installation
  13.        Guide to install this product.
  14.  
  15.        Dynaweb is a CGI program meant to be executed by an existing
  16.        HTTP server (such as the Netscape Fasttrack or Enterprise
  17.        server), allowing web-based viewing of online documentation
  18.        locally available via the IRIS InSight tool.
  19.  
  20.        Unlike previous (prior to version 3.x) releases of Dynaweb,
  21.        this version is _n_o_t a standalone web server. Therefore, this
  22.        version represents a substantial change in the method by
  23.        which the functions of Dynaweb are installed and accessed
  24.        (prior to version 3.x).
  25.  
  26.  
  27.        2.1  _D_y_n_a_w_e_b__S_u_b_s_y_s_t_e_m_s
  28.  
  29.        Dynaweb 3.1a includes these subsystems:
  30.  
  31.        _d_y_n_a_w_e_b._m_a_n._m_a_n        Dynaweb (InSight to HTML) Man Pages, 3.1a
  32.        _d_y_n_a_w_e_b._m_a_n._r_e_l_n_o_t_e_s   Dynaweb (InSight to HTML) Release Notes, 3.1a
  33.        _d_y_n_a_w_e_b._s_w._e_o_e         Dynaweb (InSight to HTML) Software, 3.1a
  34.  
  35.  
  36.  
  37.        2.2  _D_y_n_a_w_e_b__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  38.  
  39.        This section lists the subsystems (and their sizes) of
  40.        Dynaweb.
  41.  
  42.        If you are installing this product for the first time, the
  43.        subsystems marked ``default'' are the ones that are
  44.        installed if you use the ``go'' menu item.  To install a
  45.        different set of subsystems, use the ``install,''
  46.        ``remove,'' ``keep,'' and ``step'' commands in _i_n_s_t to
  47.        customize the list of subsystems to be installed, then
  48.        select the ``go'' menu item.
  49.  
  50.        Note:  The listed subsystem sizes are approximate. Refer to
  51.               the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information
  52.               on finding exact sizes.
  53.  
  54.  
  55.  
  56.        Subsystem Name                   Subsystem Size (Kilobytes)
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                   - 2 -
  70.  
  71.  
  72.  
  73.        _d_y_n_a_w_e_b._m_a_n._m_a_n (default)        4
  74.        _d_y_n_a_w_e_b._m_a_n._r_e_l_n_o_t_e_s (default)   32
  75.        _d_y_n_a_w_e_b._s_w._e_o_e (default)         5568
  76.  
  77.  
  78.  
  79.        2.3  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  80.  
  81.        All of the subsystems for Dynaweb can be installed using
  82.        IRIX.  You do not need to use the miniroot. Refer to the
  83.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete installation
  84.        instructions.
  85.  
  86.        2.4  _P_r_e_r_e_q_u_i_s_i_t_e_s
  87.  
  88.        Dynaweb requires that the latest _i_n_s_i_g_h_t__b_a_s_e._s_w._e_o_e be
  89.        installed.  You should also have some IRIS InSight books
  90.        installed.
  91.  
  92.        2.5  _C_o_n_f_i_g_u_r_a_t_i_o_n__F_i_l_e_s
  93.  
  94.        Additional IRIS InSight bookshelves can be added to Dynaweb
  95.        through modifications made to
  96.        /_u_s_r/_l_i_b/_I_n_s_i_g_h_t/_d_w_e_b/_d_a_t_a/_c_o_n_f_i_g/_c_o_l_l_e_c_t_s._d_w_c. See comments
  97.        within that file for more information.
  98.  
  99.  
  100.        2.6  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  101.  
  102.  
  103.        The Dynaweb installation links your existing IRIS InSight
  104.        library location into your HTTP server's document root. By
  105.        default, the command is as follows:
  106.  
  107.           #### llllnnnn ----ssss ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy ////vvvvaaaarrrr////wwwwwwwwwwww////hhhhttttddddooooccccssss
  108.  
  109.        This is necessary for Dynaweb to run properly. If your IRIS
  110.        InSight library location _O_R your HTTP server's document root
  111.        differ from the defaults shown above, please execute this
  112.        command (via a shell) with the correct values.
  113.  
  114.  
  115.        Dynaweb now runs as a CGI (Common Gateway Interface)
  116.        process.  Most HTTP servers from SGI ship configured for
  117.        Dynaweb to run properly.  For example, Dynaweb will work
  118.        with any server instance of Fasttrack 2.01, Enterprise 2.01,
  119.        or Enterprise 3.0 that has been correctly configured.
  120.  
  121.        If you have an existing server instance already installed
  122.        (or are having problems running Dynaweb) this server
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                                   - 3 -
  135.  
  136.  
  137.  
  138.        instance may not be properly configured for Dynaweb to work.
  139.        Follow these steps:
  140.  
  141.           +o Edit the obj.conf file for the server instance you will
  142.             be using.  For example, on a default Fasttrack 2.01
  143.             installation, the obj.conf file would be found at
  144.             (replace [hostname] with the host name of the system):
  145.  
  146.  
  147.                ////uuuussssrrrr////nnnnssss----hhhhoooommmmeeee////hhhhttttttttppppdddd----[[[[hhhhoooossssttttnnnnaaaammmmeeee]]]]////ccccoooonnnnffffiiiigggg////oooobbbbjjjj....ccccoooonnnnffff
  148.  
  149.             On a default Enterprise 3.0 installation, the obj.conf
  150.             file would be found at (replace [hostname] with the
  151.             host name of the system):
  152.  
  153.  
  154.                ////vvvvaaaarrrr////nnnneeeettttssssccccaaaappppeeee////ssssuuuuiiiitttteeeessssppppooootttt////hhhhttttttttppppssss----[[[[hhhhoooossssttttnnnnaaaammmmeeee]]]]////ccccoooonnnnffffiiiigggg////oooobbbbjjjj....ccccoooonnnnffff
  155.  
  156.           +o Locate the following line in obj.conf (exact syntax may
  157.             vary, but it is the definition of the primary /cgi-bin
  158.             directory):
  159.  
  160.  
  161.                NNNNaaaammmmeeeeTTTTrrrraaaannnnssss ffffnnnn====""""ppppffffxxxx2222ddddiiiirrrr"""" ffffrrrroooommmm====""""////ccccggggiiii----bbbbiiiinnnn"""" ddddiiiirrrr====""""////vvvvaaaarrrr////wwwwwwwwwwww////ccccggggiiii----bbbbiiiinnnn"""" nnnnaaaammmmeeee====""""ccccggggiiii""""
  162.  
  163.           +o Immediately after this line, add the following two
  164.             lines:
  165.  
  166.  
  167.                NNNNaaaammmmeeeeTTTTrrrraaaannnnssss ffffnnnn====""""ppppffffxxxx2222ddddiiiirrrr"""" ffffrrrroooommmm====""""////eeeebbbbtttt----bbbbiiiinnnn"""" ddddiiiirrrr====""""////uuuussssrrrr////lllliiiibbbb////IIIInnnnssssiiiigggghhhhtttt////ddddwwwweeeebbbb////ccccggggiiii----bbbbiiiinnnn"""" nnnnaaaammmmeeee====""""ccccggggiiii""""
  168.                NNNNaaaammmmeeeeTTTTrrrraaaannnnssss ffffnnnn====""""ppppffffxxxx2222ddddiiiirrrr"""" ffffrrrroooommmm====""""////eeeebbbbtttt----iiiiccccoooonnnnssss"""" ddddiiiirrrr====""""////uuuussssrrrr////lllliiiibbbb////IIIInnnnssssiiiigggghhhhtttt////ddddwwwweeeebbbb////iiiiccccoooonnnnssss""""
  169.  
  170.             Ideally, you should use the Netscape Admin Server to
  171.             perform this operation for you. However, the lines can
  172.             be added by hand.
  173.  
  174.           +o After adding the appropriate information, the HTTP
  175.             server will need to be restarted.
  176.  
  177.        Alternatively, if you are running a NCSA-style server, place
  178.        the following lines in the file
  179.        <server_config_dir>/srm.conf:
  180.  
  181.  
  182.           AAAAlllliiiiaaaassss  ////eeeebbbbtttt----iiiiccccoooonnnnssss//// ////uuuussssrrrr////lllliiiibbbb////IIIInnnnssssiiiigggghhhhtttt////ddddwwwweeeebbbb////iiiiccccoooonnnnssss////
  183.           SSSSccccrrrriiiippppttttAAAAlllliiiiaaaassss ////eeeebbbbtttt----bbbbiiiinnnn////nnnnpppphhhh----ddddwwwweeeebbbb ////uuuussssrrrr////lllliiiibbbb////IIIInnnnssssiiiigggghhhhtttt////ddddwwwweeeebbbb////ccccggggiiii----bbbbiiiinnnn////nnnnpppphhhh----ddddwwwweeeebbbb
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                                   - 4 -
  201.  
  202.  
  203.  
  204.        2.7  _E_x_e_c_u_t_i_o_n__A_f_t_e_r__I_n_s_t_a_l_l_a_t_i_o_n
  205.  
  206.        After the software has been installed, you can examine the
  207.        contents of your IRIS InSight library under Dynaweb:
  208.  
  209.           %%%% <<<<wwwweeeebbbb____bbbbrrrroooowwwwsssseeeerrrr>>>> hhhhttttttttpppp::::////////llllooooccccaaaallllhhhhoooosssstttt////eeeebbbbtttt----bbbbiiiinnnn////nnnnpppphhhh----ddddwwwweeeebbbb////ddddyyyynnnnaaaawwwweeeebbbb
  210.  
  211.        Substitute your favorite WWW browser for "<web_browser>" in
  212.        the previous example.
  213.  
  214.        If "localhost" does not work as shown above, substitute the
  215.        appropriate HTTP server name/port for the machine in which
  216.        Dynaweb has been installed.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.